home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / pcbmail1.zip / PCBMAIL.DOC < prev    next >
Text File  |  1993-06-02  |  10KB  |  174 lines
  1.  +--------------------------[ PCBMail  Ver 1.01 ]----------------------------+
  2.  |  Written By Gary Meeker 06/01/93                        Updated 06/02/93  |
  3.  |  SYSOP: SHARP Technical Support Line BBS               Lawrenceville, GA  |
  4.  |         (404) 962-1788                          300-14400 Baud. 24 Hours  |
  5.  +---------------------------------------------------------------------------+
  6.  V1.00  06/01/93 - Initial Release
  7.  V1.01  06/02/93 - Added configuration options line
  8.                    Added 'F' option in BltScan list to force a bulletin
  9.                    Changed scan to scan for bulletins based on the length of
  10.                    the list if less characters than number of bulletins exist.
  11.                    Fixed problem reading PCBOARD.DAT files that have commas
  12.                    in the Name of the BBS or the F-Key lines. (Stupid me, I
  13.                    know better, having been bit before)
  14.  
  15. PCBMail is designed to enhance PCBoard 15.0's built in QWK Mail features.
  16. It is is installed in PCBQWK.BAT by changing the file to:
  17.  
  18. IF EXIST ABORTQWK GOTO END
  19. IF %1==COMPRESS  PCBMAIL %3 %4
  20. IF %1==COMPRESS  IF EXIST USERS.SYS DEL USERS.SYS
  21. IF %1==COMPRESS  PKZIP -ex -m %2 @%4
  22. IF %1==EXTRACT   PKUNZIP -o %2 %3
  23. IF %1==EXTRACT   PCBMAIL /I %3
  24. :END
  25.  
  26.  
  27. During Compression PCBMail will read the CONTROL.DAT file PCBoard created
  28. and rewrite a new one with ALL the conferences the User is allowed to Join.
  29. PCBMail will also create a DOOR.ID file and append the PCBQWK.LST file
  30. (referenced as %4 above) with the name of DOOR.ID, WELCOME, NEWS, GOODBYE
  31. and any Bulletins that are included during scanning. If a NEWFILES.DAT file
  32. is present in the work directory then it will be added to the PCBQWK.LST
  33. file to be included in the .QWK file automatically, but PCBMail does not
  34. generate one itself. This could be added to PCBMail.PPE easily enough and
  35. I might condsider it for a future addition.
  36.  
  37. During Extraction PCBMail will scan the .MSG file and remove any message
  38. addressed to PCBMAIL. If the Subject is ADD or DROP then the conference
  39. will be added or removed for scanning also. Currently message pointer
  40. adjustments are not supported but I'll work on it.
  41.  
  42. PCBMail needs a simple configuration file as follows:
  43.  
  44. Lawrenceville, GA
  45. (404) 962-1788
  46. CDWNGB
  47. FYYYYYYYYYNNNNNNNNNN
  48.  
  49. Line 1 is the City & State of your BBS
  50. Line 2 is the Telephone Number of the BBS
  51. Line 3 is the options list (the order is not important):
  52.        B: Scan and include new bulletins
  53.        C: Write full CONTROL.DAT, otherwise use the one from PCBOARD
  54.        D: Include DOOR.ID file
  55.        G: Include the GOODBYE file
  56.        F: Include the NEWS file regardless of date (forced)
  57.        N: Include the NEWS file if new to user
  58.        W: Include the WELCOME file
  59. Line 4 is the Main Board bulletins to scan for inclusion. A 'Y' means check
  60.        the bulletin & 'N' (or almost anything else) means don't bother.
  61.        If a bulletin is newer than the Users Last Date/Time on it will
  62.        be copied (with the appropriate naming convention) and included
  63.        in the .QWK packet). 'F' will force the bulletin regardless of date.
  64.        Only normal files are copied and Graphic or RIPscript files will not
  65.        be copied regardless of the Users current mode.
  66.  
  67. The configuration file should be in the same directory as the program file.
  68. (or PCBMail will check the environment for *.CFG and use the path it points
  69. to look for the configuration file.)
  70.  
  71. PCMail also needs a USERS.SYS file which will normally not be available.
  72. To get it you also need to install PCBMail.PPE in your PCBTEXT files
  73. entries 676, 679, 680, 685 & 686.  To do this run MKPCBTXT on each of your
  74. PCBTEXT files and change the lines to:
  75.  
  76. !C:\PCB\PPE\PCBMAIL.PPE X +OldText
  77.  
  78. where C:\PCB\PPE\PCBMAIL.PPE is the full Drive:Path\PCBMAIL.PPE of where
  79. you placed the file and X is the number of the prompt being replaced.
  80. This will allow a USERS.SYS file to be created when prompt 676 or 679 is
  81. issued and USERS.SYS will be read and deleted when prompt 680, 685 or 686
  82. is issued. OldText is the original Text of the prompt so it still gets
  83. logged. If OldText is not present then PCBMail.PPE will also write a line
  84. to the log with the origional text.
  85.  
  86. ╒══════════════════════════════════════════════════════════════════════════════╕
  87. │   Record No.:  676          Record Length:  70        Justification:  Left   │
  88. ├──────────────────────────────────────────────────────────────────────────────┤
  89. │Creating QWK Packet, please wait...                                           │
  90. │!C:\PCB\PPE\PCBMAIL.PPE 676                                                   │
  91. │      or                                                                      │
  92. │!C:\PCB\PPE\PCBMAIL.PPE 0                                                     │
  93. ╘══════════════════════════════════════════════════════════════════════════════╛
  94. ╒══════════════════════════════════════════════════════════════════════════════╕
  95. │   Record No.:  677          Record Length:  70        Justification:  Left   │
  96. ├──────────────────────────────────────────────────────────────────────────────┤
  97. │Error compressing file.                                                       │
  98. │!I:\PCB\PPE\PCBMAIL.PPE 677 +Error compressing file.                          │
  99. ╘══════════════════════════════════════════════════════════════════════════════╛
  100. ╒══════════════════════════════════════════════════════════════════════════════╕
  101. │   Record No.:  679          Record Length:  70        Justification:  Left   │
  102. ├──────────────────────────────────────────────────────────────────────────────┤
  103. │Extracting messages, please wait...                                           │
  104. │!C:\PCB\PPE\PCBMAIL.PPE 679                                                   │
  105. ╘══════════════════════════════════════════════════════════════════════════════╛
  106. ╒══════════════════════════════════════════════════════════════════════════════╕
  107. │   Record No.:  680          Record Length:  70        Justification:  Left   │
  108. ├──────────────────────────────────────────────────────────────────────────────┤
  109. │Error extracting messages.                                                    │
  110. │!C:\PCB\PPE\PCBMAIL.PPE 680 +Error extracting messages.                       │
  111. ╘══════════════════════════════════════════════════════════════════════════════╛
  112. ╒══════════════════════════════════════════════════════════════════════════════╕
  113. │   Record No.:  685          Record Length:  70        Justification:  Left   │
  114. ├──────────────────────────────────────────────────────────────────────────────┤
  115. │Message(s) successfully inserted.                                             │
  116. │!C:\PCB\PPE\PCBMAIL.PPE 685 +Message(s) successfully insetted.                │
  117. ╘══════════════════════════════════════════════════════════════════════════════╛
  118. ╒══════════════════════════════════════════════════════════════════════════════╕
  119. │   Record No.:  686          Record Length:  70        Justification:  Left   │
  120. ├──────────────────────────────────────────────────────────────────────────────┤
  121. │Message insertion failed.                                                     │
  122. │!C:\PCB\PPE\PCBMAIL.PPE 686 +Message insertion failed.                        │
  123. ╘══════════════════════════════════════════════════════════════════════════════╛
  124.  
  125. PCBMAIL.PPE also needs a configuration file named PCBMAIL.CNF and it must be
  126. in the same directory as the .PPE file. It contains 8 lines as follows:
  127.  
  128. Do you want to receive these messages
  129. QWK Packet Aborted by User.
  130. Creating QWK Packet, please wait...
  131. Error compressing file
  132. Extracting messages, please wait...
  133. Error extracting messages.
  134. Message(s) successfully inserted.
  135. Message insertion failed.
  136.  
  137. Line 1: The prompt to ask the User if they want the packet (more later)
  138. Line 2: Text to be displayed and logged if they answer NO
  139. Line 3: The text to be shown to the User for Prompt 676
  140. Line 4: The text to be shown to the User for Prompt 677
  141. Line 5: The text to be shown to the User for Prompt 679
  142. Line 6: The text to be shown to the User for Prompt 680
  143. Line 7: The text to be shown to the User for Prompt 685
  144. Line 8: The text to be shown to the User for Prompt 686
  145.  
  146. If you want the User to be prompted you need to replace the 676  in prompt 676
  147. with 0. This gives the User a chance to abort the packet after seeing how many
  148. messages it contains. If you don't use this then you can delete the line:
  149.  
  150. IF EXIST ABORTQWK GOTO END
  151.  
  152. from the PCBQWK.BAT file as it not needed. If the User aborts the transfer the
  153. text in Line 2 of the .CFG file will be shown to the User and Logged. You  may
  154. leave this line blank in which case nothing will be logged or displayed to the
  155. User.  If not blank,  you will get three lines in the Log  when an abort takes
  156. place, ie.
  157.  
  158.       QWK Packet Aborted by User.
  159.       !I:\PCB\PPE\PCBMAIL.PPE 677 +Error compressing file.
  160.       Capture Aborted.  Read Pointers Restored ...
  161.  
  162. It would be nice if PCBoard would not log a line starting with !filespec.ppe
  163. and leave it up to the .PPE  to log the appropriate text,  but such is life.
  164.  
  165. You may use 676 in a 'STANDARD' PCBTEXT file to avoid the unusual prompt from
  166. messing up an automated script and use 0 in all your other PCBTEXT files. You
  167. will want to include all the other changes in all PCBTEXT entries  or PCBMail
  168. will most likely not function properly.
  169.  
  170. Any comments would be appreciated (any donations would also be appreciated,
  171. but the idea was to enhance the internal features to avoid the need for
  172. buying a door if you didn't need the additional features they support,
  173. so don't sweat it, this is FREEWARE.)
  174.